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(54) Write anywhere file-system layout 

(57) The present invention provides a method for 
keeping a file system in a consistent state and for creat- 
ing read-only copies of a file system. Changes to the file 
system are tightly controlled. The file system 
progresses from one consistent state to another. The 
set of self-consistent blocks on disk that is rooted by the 
root inode is referred to as a consistency point. To 
implement consistency points, new data is written to 
unallocated blocks on disk. A new consistency point 
occurs when the fsinfo block (2440) is updated by writ- 
ing a new root inode for the inode file (1210) into it. 
Thus, as long as the root inode is not updated, the state 
of the file system represented on disk does not change. 
The present invention also creates snapshots (Figure 
22) that are read-onfy copies of the file system. A snap- 
shot uses no disk space when it is initially created. It is 
designed so that many different snap shots can be cre- 
ated for the same file system. Unlike prior art file sys- 
tems that create a clone by duplicating the entire inode 
file and all of the indirect blocks, the present invention 
duplicates oniy the inode that describes the inode file. A 
multi-bit free-block map file (1630) is used to prevent 
data from being overwritten on disk. 
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Description 

[0001] The present invention is related to the field of 
methods and apparatus for maintaining a consistent file 
system and for creating read-only copies of the file sys- 
tem. 

[0002] Ali file systems must maintain consistency in 
spite of system failure. A number of different consist- 
ency techniques have been used in the prior art for this 
purpose. 

[0003] One of the most difficult and time consuming 
issues in managing any file server is making backups of 
file data. Traditional solutions have been to copy the 
data to tape or other off-line media. With some file sys- 
tems, the file server must be taken off-line during the 
backup process in order to ensure that the backup is 
completely consistent. A recent advance in backup is 
the ability to quickly "clone" (i.e., a prior art method for 
creating a read-only copy of the file system on disk) a 
file system, and perform a backup from the clone 
instead of from the active file system. With this type of 
file system, it allows the file server to remain on-line dur- 
ing the backup. 

File System Consistency 

[0004] A prior art file system is disclosed by Chu- 
tarii, et al. in an article entitled The Episode File 
System, USENIX, Winter 1992, at pages 43-59. The 
article describes the Episode file system which is a file 
system using meta-data {i.e., inode tables, directories, 
bitmaps, and indirect blocks). It can be used as a stand- 
alone or as a distributed file system. Episode supports a 
plurality of separate file system hierarchies. Episode 
refers to the plurality of file systems collectively as an 
"aggregate". In particular, Episode provides a clone of 
each file system for slowly changing data. 
[0005] In Episode, each logical file system contains 
an "anode" table. An anode table is the equivalent of an 
inode table used in file systems such as the Berkeley 
Fast File System. It is a 252-byte structure. Anodes are 
used to store all user data as well as meta-dala in the 
Episode file system. An anode describes the root direc- 
tory of a file system including auxiliary files and directo- 
ries. Each such file system in Episode is referred to as a 
"fileset". All data within a fileset is beatable by iterating 
through the anode table and processing each file in 
turn. Episode creates a read-only copy of a file system, 
herein referred to as a "clone", and shares data with the 
active file system using Copy-On-Write (COW) tech- 
niques. 

[0006] Episode uses a logging technique to recover 
a file system(s) after a system crashes. Logging 
ensures that the file system meta-data are consistent. A 
bitmap table contains information about whether each 
block in the file system is allocated or not. Also, the bit- 
map table indicates whether or not each block is logged. 
All meta-data updates are recorded in a log "container" 



that stores transaction log of the aggregate. The log is 
processed as a circular buffer of disk blocks. The trans- 
action logging of Episode uses logging techniques orig- 
inally developed for databases to ensure file system 

5 consistency. This technique uses carefully order writes 
and a recovery program that are supplemented by data- 
base techniques in the recovery program. 
[0007] Other prior art systems including JFS of IBM 
and VxFS of Veritas Corporation use various forms of 

10 transaction logging to speed the recover process, but 
still require a recovery process. 

10008] Another prior art method is called the 
"ordered write" technique. It writes all disk blocks in a 
carefully determined order so that damage is minimized 

is when a system failure occurs while performing a series 
of related writes. The prior art attempts to ensure that 
inconsistencies that occur are harmless. For instance, a 
few unused blocks or inodes being marked as allocated. 
The primary disadvantage of this technique is that the 

20 restrictions it places on disk order make it hard to 
achieve high performance. 

[0009] Yet another prior art system is an elaboration 
of the second prior art method referred to as an 
"ordered write with recovery" technique. In this method, 

25 inconsistencies can be potentially harmful. However, 
the order of writes is restricted so that inconsistencies 
can be found and fixed by a recovery program. Exam- 
ples of this methodjnclude the original UNJXfile system 
and Berkeley Fast File System (FFS). This technique 

30 does reduce disk ordering sufficiently to eliminate the 
performance penalty of disk ordering. Another disad- 
vantage is that the recovery process is time consuming. 
It typically is proportional to the size of the file system. 
Therefore, for example, recovering a 5 GB FFS file sys- 

36 lem requires an hour or more to perform. 

File System Clones 

[0010] Figure 1 is a prior art diagram for the Epi- 
40 sode file system illustrating the use of copy-on-write 
(COW) techniques for creating a fileset clone. Anode 
1 10 comprises a first pointer 1 10A having a COW bit 
lhat is set. Pointer 11 OA references data block 114 
directly. Anode 110 comprises a second pointer 110B 
45 having a COW bit that is cleared. Pointer 1 1 0B of anode 
references indirect block 112. Indirect block 112 com- 
prises a pointer 112A that references data block 124 
directly. The COW bit of pointer 112A is set. Indirect 
block 112 comprises a second pointer 1 12B that refer- 
so ences data block 126. The COW bit of pointer 1 1 2B is 
cleared. 

[001 1 ] A clone anode 120 comprises a first pointer 
120A that references data block 114. The COW bit of 
pointer 120A is cleared. The second pointer 120B of 
55 clone anode 120 references indirect block 122. The 
COW bit of pointer 120B is cleared. In turn, indirect 
block 122 comprises a pointer 122 A that references 
data block 124. The COW bit of pointer 1 22A is cleared. 
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[001 2] As illustrated in Figure 1 , ever/ direct pointer 
11 OA, 112A-112B, 120A, and 122A and indirect pointer 
110B and 120B in the Episode file system contains a 
COW bit, Blocks that have not been modified are con- 
tained in both the active file system and the done, and s 
have set (1) COW bits. The COW bit is cleared (0) when 
a block that is referenced to by the pointer has been 
modified and, therefore, is part of 1he active file system 
but not the clone. 

[001 3] When a copy-on-write block is modified, as jo 
shown in Figure 1, a new block is allocated and 
updated. The COW flag in the pointer to this new block 
is then set. The COW bit of pointer 110A of original 
anode 110 is cleared. Thus, when the clone anode 120 
is created, pointer 120A of clone anode 120 references is 
data block 1 14 also. Both original anode 1 10 and clone 
anode 120 reference data block 114. Data block 124 
has also been modified as indicated by a cleared COW 
bit of pointer 112A in original indirect block 112. Thus, 
when the clone anode is created, indirect block 122 is 20 
created. Pointer 122Aof indirect block 122 references 
data block 124, and the COW bit of pointer 122A is 
cleared. Both indirect block 122 of the original anode 
1 1 0 and indirect block 122 of clone anode 1 20 reference 
data block 124. 25 
[0014] Figure 1 illustrates copying of an anode to 
create a clone anode 120 for a single file. However, 
clone anodes must be created for every file having 
changed data blocks in the file system. At the time of the 
clone, all inodes must be copied. Creating clone anodes 30 
for every modified file in the file system can consume 
significant amounts of disk space. Further, Episode is 
not capable of supporting multiple clones since each 
pointer has only one COW bit. A single COW bit is not 
able to distinguish more than one clone. For more than 35 
one clone, there is not a second COW bit that can be 
set. 

[0015] A fileset "clone" is a read-only copy of an 
active fileset wherein the active fileset is readable and 
writable. Clones are implemented using COW tech- 40 
niques, and share data blocks with an active fileset on a 
block-by-block basis. Episode implements cloning by 
copying each anode stored in a fileset. When initially 
cloned, both the writable anode of the active fileset and 
the cloned anode both point to the same data block(s). 45 
However, the disk addresses for direct and indirect 
blocks in the original anode are tagged as COW. Thus, 
an update to the writable fileset does not affect the 
clone. When a COW block is modified, a new block is 
allocated in the file system and updated with the modrf i- • so 
cation. The COW flag in the pointer to this new block is 
cleared 

[001 6] The prior art Episode system creates clones 
that duplicate the entire inode file and all of the indirect 
blocks in the file system. Episode duplicates all inodes ss 
and indirect blocks so that it can set a Copy-On-Write 
(COW) bit in all pointers to blocks that are used by both 
the active file system and the clone. In Episode, it is 



important to identify these blocks so that new data writ- 
ten to the active file system does not overwrite "old" 
data that is part of the clone and, therefore, must not 
change. 

[0017] Creating a clone in the prior art can use up 
as much as 32 MB on a 1 GB disk. The prior art uses 
256 MB of disk space on a 1 GB disk (for 4 KB blocks) 
to keep eight clones of the file system. Thus, the prior 
art cannot use large numbers of clones to prevent loss 
of data. Instead it used to facilitate backup of the file 
system onto an auxiliary storage means other than Ihe 
disk drive, such as a tape backup device. Clones are 
used to backup a file system in a consistent state at the 
instant the clone is made. By cloning the file system, the 
clone can be backed up to the auxiliary storage means 
without shutting down the active file system, and 
thereby preventing users from using the file system. 
Thus, clones allow users to continue accessing an 
active file system while the file system, in a consistent 
state is backed up. Then the clone is deleted once the 
backup is completed. Episode is not capable of support- 
ing multiple clones since each pointer has only one 
COW bit. A single COW bit is not able to distinguish 
more than one clone. For more than one clone, there is 
no second COW bit that can be set. 
[0018] A disadvantage of the prior art system for 
creating file system clones is that it involves duplicating 
all of the inodes and all of the indirect blocks in the file 
system. For a system with many small files, the inodes 
alone can consume a significant percentage of the total 
disk space in a file system. For example, a 1 GB file sys- 
tem that is filled with 4 KB files has 32 MB of inodes. 
Thus, creating an Episode clone consumes a significant 
amount of disk space, and generates large amounts 
(i.e., many megabytes) of disk traffic. As a result of 
these conditions, creating a clone of a fiie system takes 
a significant amount of time to complete. 
[001 9] Another disadvantage of the prior art system 
is that it makes it difficult to create multiple clones of the 
same file system. The result of this is that clones tend to 
be used, one at a time, for short term operations such 
as backing up the fiie system to tape, and are then 
deleted. 

[0020] The present invention, which is defined in 
the appended claims, provides a method for maintaining 
a file system in a consistent state and for creating read- 
only copies of a file system. Changes to the file system 
are tightly controlled to maintain the file system in a con- 
sistent state. The file system progresses from one self- 
consistent state to another self -consistent state. The set 
of self-consistent blocks on disk that is rooted by the 
root inode is referred to as a consistency point (CP). To 
implement consistency points, WAFL always writes new 
data to unallocated blocks on disk. If never overwrites 
existing data. A new consistency point occurs when the 
fsinfo block is updated by writing a new root inode for 
the inode file into it. Thus, as long as the root inode is 
not updated, the state of the file system represented on 
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disk does not change. 

[0021] The present invention also creates snap- 
shots, which are virtual read-only copies of the file sys- 
tem. A snapshot uses no disk space when it is initially 
created. It is designed so that many different snapshots 
can be created for the same fiie system. Unlike prior art 
file systems that create a clone by duplicating the entire 
inode file and all of the indirect blocks, the present 
invention duplicates only the inode that describes the 
inode file. Thus, the actual disk space required for a 
snapshot is only the 128 bytes used to store the dupli- 
cated mode. The 128 bytes of the present invention 
required for a snapshot is significantly less than the 
many megabytes used for a clone in the prior art. 
[0022] The present invention prevents new data 
written to the active file system from overwriting "old" 
data that is part of a snapshot(s). It is necessary that old 
data not be overwritten as long as it is part of a snap- 
shot. This is accomplished by using a multi-bit free- 
biock map. Most prior art file systems use a free block 
map having a single bit per block to indicate whether or 
not a block is allocated. The present invention uses a 
block map having 32-bit entries. A first bit indicates 
whether a block is used by the active fiie system, and 20 
remaining bits are used for up to 20 snapshots, how- 
ever, some bits of the 31 bits may be used for other pur- 
poses. 

[0023] The present invention will be described 
below with reference to the following description of 
exemplary embodiments and the accompanying draw- 
ings, in which: 

Figure 1 is a block diagram of a prior art "clone" of 
a file system. 

Figure 2 is a diagram illustrating a list of inodes hav- 
ing dirty buffers. 

Figure 3 is a diagram illustrating an on-disk inode of 
WAFL 40 

Figures 4A-4D are diagrams illustrating on-disk 
inodes of WAFL having different levels of indirec- 
tion. 

45 

Figure 5 is a flow diagram illustrating the method for 
generating a consistency point. 



inodes of WAFL having different levels of indirection 
according to the present invention. 



Figure 19 is a diagram illustrating changes to an 
inode file. 

Figure 20 is a diagram illustrating fsinfo blocks used 
for maintaining a file system in a consistent state. 

Figures 21 A-21F are detailed diagrams illustrating 
generations of a snapshot. 

Figure 22 is a diagram illustrating an active WAFL 
file system having three snapshots that each refer- 
ence a common file; and, 

Figures 23A-23B are diagrams illustrating the 
updating of atime. 



Figure 10 is a diagram illustrating an incore inode 
5 1020 for a file. 

Figures 11A-11D are diagrams illustrating a block 
map (blkmap) file according 1o the present inven- 
tion. 

10 

Figure 12 is a diagram illustrating an inode file 
according to the present invention. 

Figures 13A-13B are diagrams illustrating an inode 
15 map (inomap) file according to the present inven- 
tion. 

Figure 14 is a diagram illustrating a directory 
according to the present invention. 

20 

Figure 15 is a diagram illustrating a file system 
information (fsinfo) structure. 

Figure 16 is a diagram illustrating the WAFL file 
25 system. 

Figures 17A-17L are diagrams illustrating the gen- 
eration of a consistency point. 

30 Figures 18A-18C are diagrams illustrating genera- 

tion of a snapshot. 



Figure 6 is a flow diagram illustrating step 530 of [0024] A system for creating read-only copies of a 

Figure 5 for generating a consistency point. so fiie system is described. In the following description, 

numerous specific details, such as number and nature 
Figure 7 is a flow diagram illustrating step 530 of of disks, disk block sizes, etc., are described in detail in 
Figure 5 for creating a snapshot. order to provide a more thorough description of the 

present invention. It will be apparent, however, to one 
Figure 8 is a diagram iilustrating an incore inode of ss skilled in the art, that the present invention may be prac- 
WAFL according to the present invention. ticed without these specific details. In other instances, 

well-known features have not been described in detail 
Figures 9A-9D are diagrams illustrating incore so as not to unnecessarily obscure the present inven- 
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tion. 

WRITE ANYWHERE FILE-SYSTEM LAYOUT 

[0025] The present invention uses a Write Any- 
where File-system Layout (WAFL). This diskformat sys- 
tem is block based (i.e., 4 KB blocks that have no 
fragments), uses inodes to describe its files, and 
includes directories that are simply specially formatted 
files. WAFL uses files to store meta-data that describes 
the layout of the file system. WAFL meta-data files 
include: an inode file, a biock map (blkmap) file, and an 
inode map (inomap) file. The inode file contains the 
inode table for the file system. The bikmap file indicates 
which disk blocks are allocated. The inomap file indi- 
cates which inodes are allocated. On-disk and incore 
WAFL inode distinctions are discussed below. 

On-Disk WAFL Inodes 

[0026] WAFL inodes are distinct from prior art 
modes. Each on-disk WAFL inode points to 15 blocks 
having the same level of indirection. A block number is 
4-bytes long. Use of block numbers having the same 
level of indirection in an inode better facilitates recursive 
processing of a file. Figure 3 is a block diagram illustrat- 
ing an on-disk inode 3 1 0. The on-disk inode 3 1 0 is com- 
prised of standard inode information 31 OA and 16 block 
number entries 31 0B having the same level of indirec- 
tion. The inode information 31 OA comprises information 
about the owner of a file, permissions, file size, access 
time, etc. that are well-known to a person skilled in the 
art. On-disk inode 310 is unlike prior art inodes that 
comprise a plurality of block numbers having different 
levels of indirection. Keeping all block number entries 
310B in an inode 310 at the same level of indirection 
simplifies file system implementation. 
[0027] For a small file having a size of 64 bytes or 
less, data is stored directly in the inode itself instead of 
the 1 6 block numbers. Figure 4A is a diagram illustrating 
a Level 0 inode 41 0 that is similar to inode 31 0 shown in 
Figure 3- However, inode 410 comprises 64-bytes of 
data 410B instead of 16 block numbers 310B. There- 
fore, disk blocks do not need to be allocated for very 
small files. 

[0028] For a file having a size of less than 64 KB, 
each of the 16 biock numbers directly references a 4 KB 
data block. Figure 4B is a diagram illustrating a Level 1 
inode 310 comprising 16 block numbers 310B. The 
block number entries 0-15 point to corresponding 4 KB 
data blocks 420A-420C, 

[0029] For a file having a size that is greater than or 
equal to 64 KB and is less than 64 MB, each of the 1 6 
block numbers references a single-indirect block. In 
turn, each 4 KB single-indirect block comprises 1024 
block numbers that reference 4 KB data blocks. Figure 
4C is a diagram illustrating a Level 2 inode 31 0 compris- 
ing 16 biock numbers 310B that reference 16 single- 



indirect blocks 430A-430C. As shown in Figure 4C, 
block number entry 0 points to single-indirect block 
430A. Single-indirect block 430A comprises 1024 block 
numbers that reference 4 KB data blocks 440A-440C. 

5 Similarly, single-indirect blocks 430B-430C can each 
address up to 1024 data blocks. 
[0030] For a file size greater than 64 MB, the 16 
block numbers of the inode reference double-indirect 
blocks. Each 4 KB double-indirect block comprises 

to 1024 block numbers pointing to corresponding single- 
indirect blocks. In turn, each single-indirect block com- 
prises 1024 block numbers that point to 4KB data 
blocks. Thus, up to 64 GB can be addressed. Figure 4D 
is a diagram illustrating a Level 3 inode 310 comprising 

is 16 block numbers 310B wherein block number entries 
0, 1. and 15 reference double-indirect blocks 470A, 
470 B, and 470C, respectively. Double-indirect block 
470A comprises 1024 block number entries 0-1023 that 
point to 1024 single-indirect blocks 480A-480B. Each 

20 single-indirect block 480A-480B, in turn, references 
1 024 data blocks. As shown in Figure 4D, single-indirect 
block 480A references 1024 data blocks 490A-490C 
and single-indirect block 480B references 1024 data 
blocks 490C-490F. 

25 

Incore WAFL inodes 

[0031] Figure 8 is a block diagram illustrating an 
incore WAFL inode 820. The incore inode 820 corn- 
so prises the information of on-disk inode 31 0 (shown in 
Figure 3), a WAFL buffer data structure 820A, and 16 
buffer pointers 820 B. A WAFL incore inode has a size of 
300 bytes. A WAFL buffer is an incore (in memory) 4 KB 
equivalent of the 4 KB blocks that are stored on disk. 
35 Incore inode 820 is unlike prior art inodes that reference 
buffers having different levels of indirection. Each incore 
WAFL inode 820 points to 16 buffers having the same 
level of indirection. A buffer pointer is 4-bytes long. 
Keeping all buffer pointers 820B in an inode 820 at the 
40 same level of indirection simplifies file system imple- 
mentation. Incore inode 820 also contains incore infor- 
mation 820C comprising a dirty flag, an in-consistency 
point (IN_CP) flag, and pointers for a linked list. The 
dirty flag indicates that the inode itself has been modi- 
45 tied or that if references buffers that have changed. The 
IN_CP flag is used to mark an inode as being in a con- 
sistency point (described below). The pointers for a 
linked list are described below. 
[0032] Figure 10 is a diagram illustrating a file refer- 
so enced by a WAFL inode 1010. The file comprises indi- 
rect WAFL buffers 1020-1024 and direct WAFL buffers 
1030-1034. The WAFL in-core inode 1010 comprises 
standard inode information 1010A (including a count of 
dirty buffers), a WAFL buffer data structure 1010B, 16 
55 buffer pointers 1010C and a standard on-disk inode 
101 OD. The in-core WAFL inode 1010 has a size of 
approximately 300 bytes. The on-disk inode is 128 
bytes in size. The WAFL buffer data structure 1010B 
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comprises two pointers where the first one references 
the 1 6 buffer pointers 1 01 OC and the second references 
the on-disk biock numbers 101 OD. 
[0033] Each inode 1010 has a count of dirty buffers 
that it references. An inode 1010 can be put in the list of 
dirty inodes and/or the list of inodes that have dirty buff- 
ers. When all dirty buffers referenced by an inode are 
either scheduled to be written to disk or are written to 
disk, the count of dirty buffers to inode 1010 is set to 
zero. The inode 1010 is then requeued according to its 
flag (i.e., no dirty buffers). This inode 1010 is cleared 
before the next inode is processed. Further the flag of 
the inode indicating that it is in a consistency point is 
cleared. The inode 1010 itself is written to disk in a con- 
sistency point. 

[0034] The WAFL buffer structure is illustrated by 
indirect WAFL buffer 1020. WAFL buffer 1020 com- 
prises a WAFL buffer data structure 1020A, a 4 KB 
buffer 1020B comprising 1024 WAFL buffer pointers 
and a 4 KB buffer 1020C comprising 1024 on-disk block 
numbers. The WAFL buffer data structure is 56 bytes in 
size and comprises 2 pointers. One pointer of WAFL 
buffer data structure 1020A references 4 KB buffer 
1020B and a second pointer references buffer 1020C. In 
Figure 10, the 16 buffer pointers 1010C of WAFL inode 
1010 point to the 16 single-indirect WAFL buffers 1020- 
1024. In turn, WAFL buffer 1020 references 1024 direct 
WAFL buffer structures 1030-1034. WAFL buffer 1030 
is representative direct WAFL buffers. 
[0035] Direct WAFL buffer 1030 comprises WAFL 
buffer data structure 1030A and a 4 KB direct buffer 
1030B containing a cached version of a corresponding 
on-disk 4 KB data block. Direct WAFL buffer 1030 does 
not comprise a 4 KB buffer such as buffer 1020C of indi- 
rect WAFL buffer 1020. The second buffer pointer of 
WAFL buffer data structure 1030A is zeroed, and there- 
fore does not point to a second 4 KB buffer. This pre- 
vents inefficient use of memory because memory space 
would be assigned for an unused buffer otherwise. 
[0036] In the WAFL file system as shown in Figure 
10, a WAFL in-core inode structure 1010 references a 
tree of WAFL buffer structures 1020-1024 and 1030- 
1034. It is similar to a tree of blocks on disk referenced 
by standard inodes comprising block numbers that 
pointing to indirect and/or direct blocks. Thus, WAFL 
inode 1010 contains not only the on-disk inode 1010D 
comprising 16 volume biock numbers, but also com- 
prises 16 buffer pointers 1O10C pointing to WAFL buffer 
structures 1020-1024 and 1030-1034. WAFL buffers 
1030-1034 contain cached contents of blocks refer- 
enced by volume block numbers. 
[0037] The WAFL in-code inode 1010 contains 16 
buffer pointers 1010C. In turn, the 16 buffer pointers 
1010C are referenced by a WAFL buffer structure 
101 0B that roots the tree of WAFL buffers 1020-1024 
and 1030-1034. Thus, each WAFL inode 1010 contains 
a WAFL buffer structure 1010B that points to the 16 
buffer pointers 1010C in the inode 1010. This facilitates 



algorithms for handling trees of buffers that are imple- 
mented recursively. If the 16 buffer pointers 101 0C in 
the inode 1010 were not represented by a WAFL buffer 
structure 10108, the recursive algorithms for operating 
5 on an entire tree of buffers 1020-1024 and 1030-1034 
would be difficult to implement. 

[0038] Figures 9A-9D are diagrams illustrating 
inodes having different levels of indirection. In Figures 
9A-9D, simplified indirect and direct WAFL buffers are 

io illustrated to show indirection. However, it should be 
understood that the WAFL buffers of Figure 9 represent 
corresponding indirect and direct buffers of Figure 10. 
For a small file having a size of 64 bytes or less, data is 
stored directly in the inode itself instead of the 1 6 buffer 

v5 pointers. Figure 9A is a diagram illustrating a Level 0 
inode 820 that is the same as inode 820 shown in Fig- 
ure 8 except that inode 820 comprises 64-bytes of data 
920B instead of 16 buffer pointers 820B. Therefore, 
additional buffers are not allocated for very small files. 

20 [0039] For a file having a size of less than 64 KB, 
each of the 16 buffer pointers directly references a 4 KB 
direct WAFL buffer. Figure 9B is a diagram illustrating a 
Level 1 inode 820 comprising 16 buffer pointers 820B. 
The buffer pointers PTR0-PTR15 point to correspond- 

25 ing 4 KB direct WAFL buffers 922A-922C. 

[0040] For a file having a size that is greater than or 
equal to 64 KB and is less than 64 MB, each of the 16 
buffer pointers references a single-indirect WAFL buffer, 
in turn, each 4 KB single-indirect WAFL buffer com- 
ae prises 1024 buffer pointers that reference 4 KB direct 
WAFL buffers. Figure 9C is a diagram illustrating a Level 
2 inode 820 comprising 16 buffer pointers 820B that ref- 
erence 16 singie-indirect WAFL buffers 930A-930C. As 
shown in Figure 9C, buffer pointer PTR0 points to sin- 

35 gle-indirect WAFL buffer 930A. Single-indirect WAFL 
buffer 930A comprises 1024 pointers that reference 4 
KB direct WAFL buffers 940A-940C. Similarly, single- 
indirect WAFL buffers 930B-930C can each address up 
to 1 024 direct WAFL buffers. 

40 [0041] For a file size greater than 64 MB, the 16 
buffer pointers of the inode reference double-indirect 
WAFL buffers. Each 4 KB double-indirect WAFL buffer 
comprises 1024 pointers pointing to corresponding sin- 
gle-indirect WAFL buffers. In turn, each single-indirect 

45 WAFL buffer comprises 1 024 pointers that point to 4KB 
direct WAFL buffers. Thus, up to 64 GB can be 
addressed. Figure 9D is a diagram illustrating a Level 3 
inode 820 comprising 16 pointers 820B wherein point- 
ers PTR0, PTR1, and PTR15 reference double-indirect 

so WAFL buffers 970A, 970B, and 970C, respectively. Dou- 
ble-indirect WAFL buffer 970A comprises 1024 pointers 
that point to 1024 single-indirect WAFL buffers 980A- 
980B. Each singie-indirect WAFL buffer 980A-980B, in 
turn, references 1024 direct WAFL buffers. As shown in 

ss Figure 9D, single-indirect WAFL buffer 980A references 
1024 direct WAFL buffers 990A-990C and single-indi- 
rect WAFL buffer 980B references 1024 direct WAFL 
buffers 990D-990F. 
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Directories 

[0042] Directories in the WAFL system are stored in 
4 KB blocks that are divided into two sections. Figure 14 
is a diagram illustrating a directory block 1410 accord- 
ing to the present invention. Each directory block 1410 
comprises a first section 1410A comprising fixed length 
directory entry structures 1412-1414 and a second sec- 
tion 1 41 0B containing the actual directory names 1416- 
1418. Each directory entry also contains a file id and a 
generation. This information identifies what file the entry 
references. This information is well-known in the art, 
and therefore is not illustrated in Figure 14. Each entry 
1412-1414 in the first section 1410A of the directory 
block has a pointer to its name in the second section 
141 0B. Further, each entry 1412-1414 includes a hash 
value dependent upon its name in the second section 
1 41 0B so that the name is examined only when a hash 
hit (a hash match) occurs. For example, entry 1412 of 
the first section 141 OA comprises a hash value 1412A 
and a pointer 1412B. The hash value 1412A is a value 
dependent upon the directory name 
"D I R ECTO RY_AB C" stored in variable length entry 
1416 of the second section 1410B. Pointer 1412B of 
entry 1410 points to the variable length entry 1416 of 
second section 141 0B. Using fixed length directory 
entries 1412-1414 in the first section 141 OA speeds up 
the process of name lockup. A calculation is not 
required to find the next entry in a directory block 1410. 
Further, keeping entries 1412-1414 in the first section 
small 141 OA improves the hit rate for file systems with a 
line-fill data cache. 

M eta-Data 

[0043] WAFL keeps information that describes a file 
system in files known as meta-data. Meta-data com- 
prises an inode file, inomap file, and a blkmap file. 
WAFL stores its meta-data in files that may be written 
anywhere on a disk Because all WAFL meta-data is 
kept in files, it can be written to any location jusf like any 
other file in the file system. 

[0044] An first meta-data file is the "inode file" that 
contains inodes describing all other files in the file sys- 
tem. Figure 12 is a diagram illustrating an inode file 
1210. The inode file 121 0 may be written anywhere on 
a disk unlike prior art systems that write "inode tables" 
to a fixed location on disk. The inode file 1210 contains 
an inode 1210A-1210F for each file in Ihe file system 
except for the inode file 1210 itself. The inode file 1210 
is pointed to by an inode referred to as the "root inode". 
The root inode is kept in a fixed location on disk referred 
to as the file system information (fsinfo) block described 
below. The inode file 1210 itself is stored in 4 KB blocks 
on disk (or 4 KB buffers in memory). Figure 12 illus- 
trates that inodes 1210A-1210C are stored in a 4 KB 
buffer 1220. For on-disk inode sizes of 128 bytes, a 4 
KB buffer (or block) comprises 32 inodes. The incore 



inode file 1210 is composed of WAFL buffers 1220. 
When an incore inode (i.e., 121 OA) is loaded, the on- 
disk inode part of the incore inode 1 21 OA is copied in for 
the buffer 1220 of the inode file 1210. The buffer data 

5 itself is loaded from disk. Writing data to disk is done in 
the reverse order. The incore inode 1210A, which is a 
copy of the ondisk inode, is copied to the corresponding 
buffer 1220 of the inode file 1210. Then, the inode file 
1210 is write-allocated, and the data stored in the buffer 

10 1 220 of the inode file 1 21 0 is written to disk. 

[0045] Another meta-data file is the "block map" 
(blkmap) file. Figure 1 1A is a diagram illustrating a blk- 
map file 1110. The blkmap file 1110 contains a 32-bit 
entry 1 1 1 0A- 1 1 1 0C for each 4 KB block in the disk sys- 

15 tern. It also serves as a free-block map file. The blkmap 
file 1 1 1 0 indicates whether or not a disk block has been 
allocated. Figure 11B is a diagram of a block entry 
1110A of blkmap file 1110 (shown in Figure 11A). As 
shown in Figure 11B, entry 1110A is comprised of 32 

20 bits (BIT0-BIT31). Bit 0 (BIT0) of entry 111 OA is the 
active file system bit (FS-BIT). The FS-bit of entry 
1 1 10A indicates whether or not the corresponding block 
is part of the active file system. Bits 1-20 (B1T1-BIT20) 
of entry 1 1 1 0A are bits that indicate whether the block is 

25 part of a corresponding snapshot 1-20. The next upper 
10 bits (BIT21-BIT30) are reserved. Bit 31 (B!T31)isthe 
consistency point bit (CP-BIT) of entry 111 OA. 
[0046] A block is available as a free block in the file 
system when all bits (BIT0-BIT31) in the 32-bit entry 

30 1 1 1 0A tor the block are clear (reset to a value of 0) . Fig- 
ure 11C is a diagram illustrating entry 11 10A of Figure 
1 1 A indicating the disk block is free. Thus, the block ref- 
erenced by entry 1 1 1 0A of blkmap file 1 1 1 0 is free when 
bits 0-31 (BIT0-B1T31) all have values of 0. Figure 11D 

3s is a diagram illustrating entry 1 1 1 0A of Figure 1 1 A indi- 
cating an allocated block in the active file system. When 
bit 0 (BIT0), also referred to as the FS-bit, is set to a 
value of 1 , the entry 1 1 1 0A of blkmap file 1110 indicates 
a block that is part of the active file system. Bits 1-20 

40 (BIT1-BIT20) are used to indicate corresponding snap- 
shots, if any, that reference the block. Snapshots are 
described in detail below. If bit 0 (BIT0) is set to a value 
of 0, this does not necessarily indicate that the block is 
available for allocation. All the snapshot bits must also 

45 be zero for the block to be allocated. Bit 31 (B1T31) of 
entry 1 1 10A always has the same state as bit 0 (BIT0) 
on disk, however, when loaded into memory bit 31 
(BIT31) is used for bookkeeping as part of a consist- 
ency point. 

so [0047] Another meta-data file is the "inode map" 
(inomap) file that serves as a free inode map. Figure 
13A is a diagram illustrating an inomap file 1310. The 
inomap file 1310 contains an 8-bit entry 1310A-1310C 
for each block in the inode file 1210 shown in Figure 12. 
55 Each entry 1310A-1310C is a count of allocated inodes 
in the corresponding block of the inode file 1210. Figure 
13A shows values of 32,5, and 0 in entries 131 0A- 
1310C, respectively. The inode file 1210 must still be 
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inspected to find which inodes in the block are tree, but 
does not require large numbers of random blocks to be 
loaded into memory from disk. Since each 4 KB block 
1220 of inode file 1210 holds 32 inodes, the 8-bit 
inomap entry 1310A-1310C for each block of inode file 5 
1210 can have values ranging from 0 to 32. When a 
block 1220 of an inode file 1210 has no inodes in use, 
the entry 1310A-1310C for it in inomap file 1310 is 0. 
When all the inodes in the block 1220 inode file 1210 
are in use, the entry 1310A-1310C of the inomap file J0 
1310 has a value of 32. 

[0048] Figure 13B is a diagram illustrating an 
inomap file 1350 that references the 4 KB blocks 
1340A-1340C of inode file 1340. For example, inode file 
1340 stores 37 inodes in three 4 KB blocks 1340A- w 
1340C. Blocks 1340A-1340C of inode file 1340 contain 
32, 5, and 0 used modes, respectively. Entries 1350A- 
1350C of blkmap file 1350 reference blocks 1340A- 
1340C of inode file 1340, respectively. Thus, the entries 
1350A-1 350C of inomap file have values of 32,5, and 0 20 
for blocks 1340A-1340C of inode file 1340. In turn, 
entries 1350A-1350C of inomap file indicate 0, 27, and 
32 free inodes in blocks 1340A-1340C of inode fiie 
1340, respectively. 

[0049] Referring to Figure 13, using a bitmap for the ss 
entries 1310A-1310C of inomap file 1310 instead of 
counts is disadvantageous since it would require 4 
bytes per entry 1310A-1310C for block 1220 of the 
inode fiie 1 21 0 (shown in Figure 12) instead of one byte. 
Free inodes in the block(s) 1220 of the inode file 1210 30 
do not need to be indicated in the inomap file 1310 
because the inodes themselves contain that informa- 
tion. 

[0050] Figure 15 is a diagram illustrating a file sys- 
tem information (fsinfo) structure 1510. The root inode 35 
151 0B of a fiie system is kept in a fixed location on disk 
so that it can be located during booting of the file sys- 
tem. The fsinfo block is not a meta-data file but is part of 
the WAFL system. The root inode 1 51 0B is an inode ref- 
erencing the inode file 1 21 0. It is part of the file system 40 
information (fsinfo) structure 1510 that also contains 
information 151 OA including the number of blocks in the 
file system, the creation time of the file system, etc. The 
miscellaneous information 1510A further comprises a 
checksum 1 510C (described below). Except for the root 45 
inode 151 0B itself, this information 1510Acan be kept in 
a meta-data file in an alternate embodiment. Two identi- 
cal copies of the fsinfo structure 1510 are kept in fixed 
locations on disk. 

[0051 ] Figure 1 6 is a diagram illustrating the WAFL so 
file system 1670 in a consistent state on disk compris- 
ing two fsinfo blocks 1610 and 1612, inode file 1620, 
blkmap file 1630, inomap file 1640, root directory 1650, 
and a typical fiie (or directory) 1660. Inode fiie 1620 is 
comprised of a plurality of inodes 1 620A-1620D that ref- ss 
erence other fiies 1630-1660 in the file system 1670. 
Inode 1620A of inode file 1620 references blkmap fiie 
1630. Inode 1620B references inomap fiie 1640. Inode 



1 620 C references root directory 1650. Inode 1620D ref- 
erences a typical file (or directory) 1660. Thus, the 
inode file points to all files 1630-1660 in the file system 
1670 except for fsinfo blocks 1610 and 1612. Fsinfo 
blocks 1610 and 1612 each contain a copy 161 0B and 
1612B of the inode of the inode file 1620, respectively. 
Because the root inode 1610B and 1612B of fsinfo 
blocks 1610 and 1612 describes the inode file 1620, 
that in turn describes the rest of the files 1630-1660 in 
the fiie system 1670 including all meta-data files 1630- 
1640, the root inode 161 0B and 1612B is viewed as the 
root of a tree of blocks. The WAFL system 1670 uses 
this tree structure for its update method (consistency 
point) and for implementing snapshots, both described 
below. 

List of Inodes Having Dirtv Blocks 

[0052] WAFL in-core inodes (i.e., WAFL inode 1010 
shown in Figure 10) of the WAFL file system are main- 
tained in different linked lists according to their status. 
Inodes that reference dirty blocks are kept in a dirty 
inode list as shown in Figure 2. Inodes containing valid 
data that is not dirty are kept in a separate list and 
inodes that have no valid date are kept in yet another, as 
is well-known in the art. The present invention utilizes a 
list of inodes having dirty data blocks that facilitates find- 
ing all of the inodes that need write allocations to be 
done. 

[0053] Figure 2 is a diagram illustrating a list 210 of 
dirty inodes according to the present invention. The list 
210 of dirty inodes comprises WAFL in-core inodes 
220-1750. As shown in Figure 17, each WAFL in-core 
inode 220-250 comprises a pointer 220A-250A, respec- 
tively, that points to another inode in the linked list. For 
example, WAFL inodes 220-250 are stored in memory 
at locations 2048, 2152, 2S78, 3448 and 3712, respec- 
tively. Thus, pointer 220A of inode 220 contains address 
2152. It points therefore to WAFL inode 222. in turn, 
WAFL inode 222 points to WAFL inode 230 using 
address 2878. WAFL inode 230 points to WAFL inode 
240. WAFL inode 240 points to inode 1750. The pointer 
250A of WAFL inode 250 contains a null value and 
therefore does not point to another inode. Thus, it is the 
last inode in the list 210 of dirty inodes. Each inode in 
the list 210 represents a file comprising a tree of buffers 
as depicted in Figure 10. At least one of the buffers ref- 
erenced by each inode 220-250 is a dirty buffer. A dirty 
buffer contains modified data that must be written to a 
new disk location in the WAFL system. WAFL always 
writes dirty buffers to new locations on disk. 

CONSISTENCY POINTS 

[0054] The WAFL disk structure described so far is 
static. In the present invention, changes to the file sys- 
tem 1670 are tightly controlled to maintain the file sys- 
tem 1670 in a consistent state. The file system 1670 
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progresses from one self-consistent state to another 
self-consistent state. The set (or tree) of self-consistent 
blocks on disk that is rooted by the root inode 1 510B is 
referred to as a consistency point (CP). To implement 
consistency points, WAFL always writes new data to 5 
unallocated blocks on disk. It never overwrites existing 
data. Thus, as long as the root inode 151 OB is not 
updated, the state of the file system 1670 represented 
on disk does not change. However, for a file system 
1 670 to be useful, it must eventually refer to newly writ- 70 
ten data, therefore a new consistency point must be 
written. 

[0055] Referring to Figure 16, a new consistency 
point is written by first flushing all file system blocks to 
new locations on disk (including the blocks in meta-data 15 
files such as the inode file 1820, bikmap file 1630, and 
inomapfile 1640). A new root inode 1610B and 1612B 
for the file system 1670 is then written to disk. With this 
method for atomically updating a file system, the on- 
disk file system is never inconsistent. The on-disk file 20 
system 1670 reflects an old consistency point up until 
the root inode 161 0B and 1612B is written. Immediately 
after the root inode 1610B and 1612B is written to disk, 
the file system 1670 reflects a new consistency point. 
Data structures of the file system 1 670 can be updated 25 
in any order, and there are no ordering constraints on 
disk writes except the one requirement that ail blocks in 
the file system 1670 must be written to disk before the 
root inode 161 0B and 1612B is updated. 
[0056] To convert to a new consistency point, the 30 
root inode 161 0B and 1612B must be updated reliably 
and atomically. WAFL does this by keeping two identical 
copies of the fsinfo structure 1610 and 1612 containing 
the root inode 161 0B and 1612B. During updating of the 
root inode 161 0B and 1612B, a first copy of the fsinfo 35 
structure 1610 is written to disk, and then the second 
copy of the fsinfo structure 1612 is written. A checksum 
1610Cand 1 61 2C in the fsinfo structure 1610 and 1612, 
respectively, is used to detect the occurrence of a sys- 
tem crash that corrupts one of the copies of the fsinfo 40 
structure 1610 or 1612, each containing a copy of the 
root inode, as it is being written to disk. Normally, the 
two fsinfo structures 1610 and 1612 are identical. 

Algorithm for Generating a Consistency Point as 

[0057] Figure 5 is a diagram illustrating the method 
of producing a consistency point. In step 51 0, all "dirty" 
inodes (modes thai point to new blocks containing mod- 
ified data) in the system are marked as being in the con- so 
sistency point their contents, and only their contents, 
are written to disk. Only when those writes are complete 
are any writes from other inodes allowed to reach disk. 
Further, during the time dirty writes are occurring, no 
new modifications can be made to inodes that are in the ss 
consistency point. 

[0058] In addition to setting the consistency point 
flag for all dirty inodes that are part of the consistency 



point, a global consistency point flag is set so that user- 
requested changes behave in a tightly controlled man- 
ner. Once the global consistency point flag is set, user- 
requested changes are not allowed to affect inodes that 
are in the consistency point. Further, only inodes having 
a consistency point flag that is set are allocated disk 
space for their dirty blocks. Consequently, the state of 
the file system will be flushed to disk exactiy as it was 
when the consistency point began. 
[0059] In step 520, regular files are flushed to disk. 
Flushing regular files comprises the steps of allocating 
disk space for dirty blocks in the regular files, and writ- 
ing the corresponding WAFL buffers to disk. The inodes 
themselves are then flushed (copied) to the inode file. 
All inodes that need to be written are in either the list of 
inodes having dirty buffers or the list of inodes that are 
dirty but do not have dirty buffers. When step 520 is 
completed, there are no more ordinary inodes in the 
consistency point, and all incoming I/O requests suc- 
ceed unless the requests use buffers that are still locked 
up for disk I/O operations. 

[0060] In step 530, special files are flushed to disk. 
Flushing special files comprises the steps of allocating 
disk space for dirty blocks in the two special files: the 
inode file and the bikmap file, updating the consistency 
bit (CP-bit) to match the active file system bit (FS-bit) for 
each entry in the bikmap file, and then writing the blocks 
to disk. Write allocating the inode file and the bikmap is 
complicated because the process of write allocating 
them changes the files themselves. Thus, in step 530 
writes are disabled while changing these files to prevent 
important blocks from locking up in disk I/O operations 
before the changes are completed. 
[0061] Also, in step 530, the creation and deletion 
of snapshots, described below, are performed because 
it is the only point in time when the file system, except 
for the fsinfo block, is completely self consistent and 
about to be written to disk. A snapshot is deleted from 
the file system before a new one is created so that the 
same snapshot inode can be used in one pass. 
[0062] Figure 6 is a flow diagram illustrating the 
steps that step 530 comprises. Step 530 allocates disk 
space for the bikmap file and the inode file and copies 
the active FS-bit into the CP-bit for each entry in the bik- 
map file. In step 610, the inode for the bikmap file ispre- 
flushed to the inode file. This ensures that the block in 
the inode file that contains the inode of the bikmap file is 
dirty so that step 620 allocates disk space for it. 
[0063] In step 620, disk space is allocated for all 
dirty blocks in the inode and bikmap files. The dirty 
blocks include the block in the inode file containing the 
inode of the bikmap file is dirty. 
[0064] In step 630, the inode for the bikmap file is 
flushed again, however this time the actual inode is writ- 
ten to the pre-f lushed block in the inode file. Step 610 
has already dirtied the block of the inode file that con- 
tains the inode of the bikmap file. Thus, another write- 
allocate, as in step 620, does not need to be scheduled. 
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[0065] In step 640, the entries for each block in the 
blkmap file are updated. Each entry is updated by copy- 
ing the active FS-bit to the CP-bit (i.e., copying bit 0 into 
bit 31) for all entries in dirty blocks in the blkmap file. 
[0066] In step 650, all dirty blocks in the blkmap and 
inode files are written to disk. 

[0067] Only entries in dirty biocks of the blkmap file 
need to have the active file system bit (FS-bit) copied to 
the consistency point bit (CP-bit) in step 640. Immedi- 
ately after a consistency point, ail blkmap entries have 
same value for both the active FS-bit and CP-bit As time 
progresses, some active FS-bits of blkmap file entries 
for the file system are either cleared or set. The blocks 
of the blkmap file containing the changed FS-bits are 
accordingly marked dirty. During the following consist- 
ency point, blocks that are clean do not need to be re- 
copied. The clean blocks are not copied because they 
were not dirty at the previous consistent point and noth- 
ing in the blocks has changed since then. Thus, as long 
as the file system is initially created with the active FS- 
bit and the CP-bit having the same value in all blkmap 
entries, only entries with dirty blocks need to be 
updated at each consistency point. 
[0068] Referring to Figure 5, in step 540, the file 
system information (fsinfo) block updated and then 
flushed to disk. The fsinfo block is updated by writing a 
new root inode for the inode file into it. The fsinfo block 
is written twice. It isf irst written to one location and then 
to a second location. The two writes are performed so 
that when a system crash occurs during either write, a 
self-consistent file system exists on disk. Therefore, 
either the new consistency point is available if the sys- 
tem crashed while writing the second fsinfo block or the 
previous consistency point (on disk before the recent 
consistency point began) is available if the first fsinfo 
block failed. When the file system is restarted after a 
system failure, the highest generation count for a con- 
sistency point in the fsinfo blocks having a correct 
checksum value is used. This is described in detail 
below. 

[0069] In step 550, the consistency point is com- 
pleted. This requires that any dirty inodes that were 
delayed because they were not part of the consistency 
point be requeued. Any inodes lhat had their state 
change during the consistency point are in the consist- 
ency point wait (CP_WAIT) queue. The CP_WAIT 
queue holds inodes that changed before step 540 com- 
pleted, but after step 510 when the consistency point 
started. Once the consistency point is completed, the 
inodes in the CP_WAIT queue are re-queued accord- 
ingly in the regular list of inodes with dirty buffers and list 
of dirty inodes without dirty buffers. 

Single Ordering Constraint of Consistency Point 

[0070] The present invention, as illustrated in Fig- 
ures 20A-20C, has a single ordering constraint. The sin- 
gle ordering constraint is that the fsinfo block 1810 is 



written to disk only after all the other blocks are written 
to disk. The writing of the fsinfo block 1810 is atomic, 
otherwise the entire file system 1830 could be lost Thus, 
the WAFL fiie system requires the fsinfo block 1810 to 
5 be written at once and not be in an inconsistent state. 
As illustrated in Figure 15, each of the fsinfo blocks 
1810 (1510) contains a checksum 1510C and a gener- 
ation count 151 0D. 

[0071] Figure 20A illustrates the updating of the 
10 generation count 1810D and 1870D of fsinfo blocks 
1 810 and 1 870. Each time a consistency point (or snap- 
shot) is performed, the generation count of the fsinfo 
block is updated. Figure 20A illustrates two fsinfo blocks 
1810 and 1870 having generation counts 1810D and 
15 1 870 D, respectively, that have the same value of N indi- 
cating a consistency point for the file system. Both fsinfo 
blocks reference the previous consistency point (old file 
system on disk) 1830. A new version of the file system 
exists on disk and is referred to as new consistency 
20 point 1831 . The generation count is incremented every 
consistency point. 

[0072] In Figure 20B, the generation count 181 0D 
of the first fsinfo block 1810 is updated and given a 
value of N+1. It is then written to disk. Figure 20B illus- 

2s trates a value of N+1 for generation count 1810D of 
fsinfo block 1810 whereas the generation count 1870D 
of the second fsinfo block 1870 has a value of N. Fsinfo 
block 1810 references new consistency point 1831 
whereas fsinfo block 1 870 references old consistency 

3D point 1830. Next, the generation count 1870D of fsinfo 
block 1 870 is updated and written to disk as illustrated 
in Figure 20C. In Figure 20C, the generation count 
1870D of fsinfo block 1870 has a value of N+1. There- 
fore the two fsinfo blocks 1 81 0 and 1870 have the same 

3s generation count value of N+1 . 

[0073] When a system crash occurs between fsinfo 
block updates, each copy of the fsinfo block 1810 and 
1 870 will have a self consistent checksum (not shown in 
the diagram), but one of the generation numbers 1810D 

40 or 1870D will have a higher value. A system crash 
occurs when the file system is in the state illustrated in 
Figure 20 B. For example, in the preferred embodiment 
of the present invention as illustrated in Figure 20B, the 
generation count 1810D of fsinfo block 1810 is updated 

45 before the second fsinfo block 1870. Therefore, the gen- 
eration count 181 0D (value of one) is greater than the 
generation count 1870D of fsinfo block 1870. Because 
the generation count of the first fsinfo block 1810 is 
higher, it is selected for recovering the file system after 

so a system crash. This is done because the first fsinfo 
block 1810 contains more current data as indicated by 
its generation count 1810D. For the case when the first 
fsinfo block is corrupted because the system crashes 
while it is being updated, the other copy 1870 of the 

55 fsinfo block is used to recover the file system 1 830 into 
a consistent state. 

[0074] It is not possible for both fsinfo blocks 181 0 
and 1 870 to be updated at the same time in the present 
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invention. Therefore, at least one good copy of the fsinfo 
block 1810 and 1870 exists in the file system. This 
allows the file system to alsways be recovered into a 
consistent state. 

[0075] WAFL does not require special recovery pro- 
cedures. This is unlike prior art systems that use log- 
ging, ordered writes, and mostly ordered writes with 
recovery. This is because only data corruption, which 
RAID protects against, or software can corrupt a WAFL 
file system. To avoid losing data when the system fails, 
WAFL may keep a non-volatile transaction log of all 
operations that have occurred since the most recent 
consistency paint. This log is completely independent of 
the WAFL disk format and is required only to prevent 
operations from being lost during a system crash. How- 
ever, it is not required to maintain consistency of the file 
system. 

Generating A Consistency Point 

[0076] As described above, changes to the WAFL 
file system are tightly controlled to maintain the file sys- 
tem in a consistent state. Figures 1 7A-1 7H illustrate the 
generation of a consistency point for a WAFL file sys- 
tem. The generation of a consistency point is described 
with reference to Figures 5 and 6. 
[0077] In Figures 17A-17L, buffers that have not 
been modified do not have asterisks beside them. 
Therefore, buffers contain the same data as corre- 
sponding on-disk blocks. Thus, a block may be loaded 
into memory but it has not changed with respect to its 
on disk version. A buffer with a single asterisk (*) beside 
it indicates a dirty buffer in memory (its data is modi- 
fied). A buffer with a double asterisk (**) beside it indi- 
cates a dirty buffer that has been allocated disk space. 
Finally, a buffer with a triple asterisk (***) is a dirty buffer 
that is written into a new block on disk. This convention 
for denoting the state of buffers is also used with respect 
to Figures 21 A-21E. 

[0078] Figure 17A illustrates a list 2390 of inodes 
with dirty buffers comprising inodes 2306A and 2306B. 
inodes 2306A and 2306B reference frees of buffers 
where at least one buffer of each tree has been modi- 
fied, initially, the consistency point flags 2391 and 2392 
of inodes 2306A and 2306B are cleared (0). While a list 
2390 of inodes with dirty buffers is illustrated for the 
present system, it should be obvious to a person skilled 
in the art that other lists of inodes may exist in memory. 
For instance, a list of inodes that are dirty but do not 
have dirty buffers is maintained in memory. These 
inodes must also be marked as being in the consistency 
point. They must be flushed to disk also to write the dirty 
contents of the inode file to disk even though the dirty 
inodes do not reference dirty blocks. This is done in step 
520 of Figure 5. 

[0079] Figure 17B is a diagram illustrating a WAFL 
file system of a previous consistency point comprising 
fsinfo block 2302, inode file 2346, blkmap file 2344 and 



files 2340 and 2342. File 2340 comprises blocks 2310- 
2314 containing data "A", "B", and "C", respectively. File 
2342 comprises data blocks 2316-2320 comprising 
data "D", "E", and "F", respectively. Blkmap file 2344 
s comprises block 2324. The inode file 2346 comprises 
two 4KB blocks 2304 and 2306. The second block 2306 
comprises inodes 2306A-2306C that reference file 
2340, file 2342, and blkmap file 2344, respectively. This 
is illustrated in block 2306 by listing the file number in 
to the inode. Fsinfo block 2302 comprises the root inode. 
The root inode references blocks 2304 and 2306 of 
inode file 2346. Thus, Figure 17B illustrates a tree of 
buffers in a file system rooted by the fsinfo block 2302 
containing the root inode. 
is [0080] Figure 17C is a diagram illustrating two mod- 
ified buffers for blocks 2314 and 2322 in memory. The 
active file system is modified so that the block 23 1 4 con- 
taining data "C" is deleted from file 2340. Also, the data 
"F" stored in block 2320 is modified to "F-prime". and is 
£0 stored in a buffer for disk block 2322. It should be under- 
stood that the modified data contained in buffers for disk 
blocks 2314 and 2322 exists only in memory at this 
time. All other blocks in the active file system in Figure 
17C are not modified, and therefore have no asterisks 
25 beside them. However, some or all of these blocks may 
have corresponding clean buffers in memory. 
[0081] Figure 17D is a diagram illustrating the 
entries 2324A-2324M of the blkmap file 2344 in mem- 
ory. Entries 2324A-2324M are contained in a buffer for 4 
so KB block 2324 of blkmap file 2344. As described previ- 
ously, BIT0 and B1T31 are the FS-BIT and CP-BIT, 
respectively. The consistency point bit (CP-BIT) is set 
during a consistency point to ensure that the corre- 
sponding block is not modified once a consistency point 
35 has begun, but notfinished, BIT1 is the first snapshot bit 
(described below). Blkmap entries 2324A and 2324B 
, illustrate that, as shown in Figure 17B, the 4 KB blocks 
2304 and 2306 of inode file 2346 are in the active file 
system (FS-BIT equal to 1 ) and in the consistency point 
40 (CP-BIT equal to 1). Similarly the other blocks 2310- 
231 2 and 2316-2320 and 2324 are in the active file sys- 
tem and in the consistency point However, blocks 2308, 
2322, and 2326-2328 are neither in the active file sys- 
tem nor in the consistency point (as indicated by BIT0 
45 and B1T31 , respectively). The entry for deleted block 
231 4 has a value of 0 in the FS-BIT indicating that it has 
been removed from the active file system. 
[0082] In step 510 of Figure 5, all "dirty" inodes in 
the system are marked as being in the consistency 
so point. Dirty inodes include both inodes that are dirty and 
inodes that reference dirty buffers. Figure 171 illustrates 
a list of inodes with dirty buffers where the consistency 
point flags 2391 and 2392 of inodes 2306A and 2306B 
are set (1). Inode 2306A references block 231 4 contain- 
55 ing data "C" of file 2340 which is to be deleted from the 
active file system. Inode 2306B of block 2306 of inode 
file 2346 references file 2342. Block 2320 containing 
data "F" has been modified and a new block containing 
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data "F" must be allocated. In step 510. the dirty inodes 
2306A and 2306B are copied into the buffer for block 
2308. The buffer for block 2306 is subsequently written 
to disk (in step 530). This is illustrated in Figure 17E. 
The modified data exists in memory only, and the buffer s 
2308 is marked dirty. The inconsistency point flags 2391 
and 2392 of inodes 2306A and 2306B are then cleared 
(0) as illustrated in Figure 17A. This releases the inodes 
for use by other processes, 

[0033] in step 520, regular files are flushed to disk. 10 
Thus, block 2322 is allocated disk space. Block 2314 of 
file 2340 is to be deleted, therefore nothing occurs to 
this block until 1he consistency point is subsequently 
completed. Block 2322 is written to disk in step 520. 
This is illustrated in Figure 1 7F where buffers for blocks is 
2322 and 231 4 have been written to disk (marked by 
***). The intermediate allocation of disk space (**) is not 
shown. The inodes 2308A and 2308B of block 2308 of 
inode file 2346 are flushed to the inode file. Inode 
230SA of block 2308 references blocks 2310 and 2312 so 
of file 2346. Inode 2308 B references blocks 23 1 6, 23 1 8, 
2322 for file 2342. As illustrated in Figure 17F, disk 
space is allocated for block 2308 of inode 2346 and for 
direct block 2322 for file 2342. However, the file system 
itself has not been updated. Thus, the file system 25 
remains in a consistent state. 

[0084] In step 530, the blkmap file 2344 is flushed 
to disk. This is illustrated in Figure 17Q where the blk- 
map file 2344 is indicated as being dirty by the asterisk. 
[0085] In step 610 of Figure 6, the inode for the blk- 30 
map file is pre-flushed to the inode file as illustrated in 
Figure 17H. Inode 2308C has been flushed to block 
230B of inode file 2346. However, inode 2308C still ref- 
erences block 2324. In step 620, disk space is allocated 
for blkmap file 2344 and inode file 2346. Block 2308 is 35 
allocated for inode file 2346 and block 2326 is allocated 
for blkmap file 2344. As described above, block 2308 of 
inode file 2346 contains a pre-flushed inode 2308C for 
blkmap file 2344. In step 630, the inode tor the blkmap 
file 2344 is written to the pre-flushed block 2308C in 40 
inode 2346. Thus, incore inode 230BC is updated to ref- 
erence block 2324 in step 620, and is copied into the 
buffer in memory containing block 2306 that is to be 
written to block 2308. This is illustrated in Figure 1 7H 
where inode 2308C references block 2326. 45 
[0086] In step 640, the entries 2326A-2326L for 
each block 2304-2326 in the blkmap file 2344 are 
updated in Figure 1 7J. Blocks that have not changed 
since the consistency point began in Figure 17B have 
the same values in their eniries. The entries are so 
updated by copying BITO (FS-bit) to the consistency 
point bit (BIT31), Block 2306 is not part of the active file 
system, therefore BITO is equai to zero (BITO was 
turned off in step 620 when block 2308 was allocated to 
hold the new data for that part of the inode file). This is ss 
illustrated in Figure 17J for entry 2326B. Similarly, entry 
2326F for block 2314 of file 2340 has BITO and BIT31 
equal to zero. Block 2320 of file 2342 and block 2324 of 
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blkmap file 2344 are handled similarly as shown in 
entries 2361 and 2326K, respectively. In step 650, dirty 
block 2308 of inode file 2346 and dirty block 2326 of blk- 
map file 2344 are written to disk. This is indicated in Fig- 
ure 17K by a triple asterisk (***) beside blocks 2308 and 
2326. 

[0037] Referring to Figure 5, in step 540, the file 
system information block 2302 is flushed to disk, this is 
performed twice. Thus, fsinfo block 2302 is dirtied and 
then written to disk (indicated by a triple asterisk) in Fig- 
ure 17L In Figure 17L, a single fsinfo block 2302 is illus- 
trated. As shown in the diagram, fsinfo block 2302 now 
references block 2304 and 2308 of the inode file 2346. 
in Figure 1 7L, block 2306 is no longer part of the inode 
file 2346 in the active file system. Similarly, file 2340 ref- 
erenced by inode 2308A of inode file 2346 comprises 
blocks 2310 and 2312. Block 2314 is no longer part of 
file 2340 in this consistency point. File 2342 comprises 
blocks 2316, 2318, and 2322 in the new consistency 
point whereas block 2320 is not part of file 2342. Fur- 
ther, block 2308 of inode file 2346 references a new blk- 
map file 2344 comprising block 2326. 
[0088] As shown in Figure 17L, in a consistency 
point, the active file system is updated by copying the 
inode of the inode file 2346 into fsinfo block 2302. How- 
ever, the blocks 2314, 2320, 2324, and 2306 of the pre- 
vious consistency point remain on disk. These blocks 
are never overwritten when updating the file system to 
ensure that both the old consistency point 1 830 and the 
new consistency point 1831 exist on disk in Figure 20 
during step 540 

SNAPSHOTS 

[0089] The WAFL system supports snapshots. A 
snapshot is a read-only copy of an entire file system at 
a given instant when the snapshot is created. A newly 
created snapshot refers to exactly the same disk blocks 
as the active file system does. Therefore, it is created in 
a small period of time and does not consume any addi- 
tional disk space. Only as data blocks in the active file 
system are modified and written to new locations on 
disk does the snapshot begin to consume extra space. 
[0090] WAFL supports up to 20 different snapshots 
that are numbered 1 through 20. Thus, WAFL allows the 
creation of multiple "clones" of the same file system. 
Each snapshot is represented by a snapshot inode that 
is similar to the representation of the active file system 
by a root inode. Snapshots are created by duplicating 
the root data structure of thefile system, in the preferred 
embodiment, the root data structure is the root inode. 
However, any data structure representative of an entire 
file system could be used. The snapshot inodes reside 
in a fixed location in the inode file. The limit of 20 snap- 
shots is imposed by the size of the blkmap entries. 
WAFL requires two steps to create a new snapshot N: 
copy the root inode into the inode for snapshot N; and, 
copy bit 0 into bit N of each blkmap entry in the blkmap 
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file. Bit 0 indicates the blocks that are referenced by the 
tree beneath the root inode. 

[0091] The result is a new file system tree rooted by 
snapshot inode N that references exactly the same disk 
blocks as the root inode. Setting a corresponding bit in £ 
the blkmap for each block in the snapshot prevents 
snapshot blocks from being freed even if the active file 
no longer uses the snapshot blocks. Because WAFL 
always writes new data to unused disk locations, the 
snapshot tree does not change even though the active 10 
file system changes. Because a newly created snap- 
shot tree references exaclly the same blocks as the root 
inode, it consumes no additional disk space. Over time, 
the snapshot references disk blocks that would other- 
wise have been freed. Thus, over time the snapshot and is 
the active file system share fewer and fewer blocks, and 
the space consumed by the snapshot increases. Snap- 
shots can be deleted when they consume unacceptable 
numbers of disk blocks. 

10092] The list of active snapshots along with the 20 
names of the snapshots is stored in a meta-data file 
called the snapshot directory. The disk state is updated 
as described above. As with all other changes, the 
update occurs by automatically advancing from one 
consistency poi nt to another. Modified blocks are written 25 
to unused locations on the disk after which a new root 
inode describing the updated file system is written. 

Overview of Snapshots 

30 

[0093] Figure 18A is a diagram of the file system 
1830, before a snapshot is taken, where levels of indi- 
rection have been removed to provide a simpler over- 
view of the WAFL file system. The file system 1830 
represents the file system 1690 of Figure 16. The file 3s 
system 1830 is comprised of blocks 1812-1820. The 
inode of the inode file is contained in fsinfo block 1810. 
While a single copy of the fsinfo block 1810 is shown in 
Figure 1 8A, it should be understood that a second copy 
of fsinfo block exists on disk. The inode 181 OA con- 40 
tained in the fsinfo block 1810 comprises 16 pointers 
that point to 16 blocks having the same level of indirec- 
tion. The blocks 1812-1820 in Figure ISA represent all 
blocks in the file system 1830 including direct blocks, 
indirect blocks, etc. Though only five blocks 1 81 2-1 820 45 
are shown, each block may point to other blocks. 
[0094] Figure 1 8B is a diagram illustrating the crea- 
tion of a snapshot. The snapshot is made for the entire 
file system 1830 by simply copying the inode 1810A of 
the inode file that is stored in fsinfo block 1810 into the so 
snapshot inode 1822. By copying the inode 181 OA of 
the inode file, a new file of inodes is created represent- 
ing the same file system as the active file system. 
Because the inode 1810A of the inode file itself is cop- 
ied. No other blocks 1812-1820 need to be duplicated. 55 
The copied inode or snapshot inode 1 822, is then cop- 
ied into the inode file that dirties a block in the inode file. 
For an inodefile comprised of one or more levels of indi- 



103 A2 24 

rection, each indirect block is in turn dirtied. This proc- 
ess of dirtying blocks propagates through all 1he levels 
of indirection. Each 4 KB block in the inode file on disk 
contains 32 inodes where each inode is 128 bytes long. 
[0095] The new snapshot inode 1822 of figure 18B 
points back to the highest level of indirection blocks 
1812-1820 referenced by the inode 1810Aof the inode 
file when the snapshot 1822 was taken. The inode File 
itself is a recursive structure because it contains snap- 
shots of the file system 1830. Each snapshot 1822 is a 
copy of the inode 181 OA of the inode file that is copied 
into the inode file. 

[0096] Figure 18C is a diagram illustrating the 
active file system 1830 and a snapshot 1822 when a 
change to the active file system 1830 subsequently 
occurs after the snapshot 1 822 is taken. As illustrated in 
the diagram, block 1 818 comprising data "D" is modified 
after the snapshot was taken (in Figure 18B), and there- 
fore a new block 1824 containing data "D prime " is allo- 
cated for the active file system 1830. Thus, the aclive 
file system 1830 comprises blocks 1812-1816 and 
1820-1824 but does not contain block 1818 containing 
data '"D". However, block 1818 containing data "□" is 
not overwritten because the WAFL system does not 
overwrite blocks on disk. The block 1818 is protected 
against being overwritten by a snapshot bit that is set in 
the blkmap entry for block 1818. Therefore, the snap- 
shot 1822 still points to the unmodified block 1818 as 
well as blocks 1812-1816 and 1820. The present inven- 
tion, as illustrated in Figures 18A-18C, is unlike prior art 
systems that create "clones" of a file system where a 
clone is a copy of all the blocks of an inode file on disk. 
Thus, the entire contents of the prior art inode files are 
duplicated requiring large amounts (MB) of disk space 
as well as requiring substantial time for disk I/O opera- 
tions. 

[0097] As the active file system 1830 is modified in 
Figure 18C, it uses more disk space because the file 
system comprising blocks 1812-1820 is not overwritten. 
In Figure 18C, block 1818 is illustrated as a direct block. 
However, in an actual file system, block 1818 may be 
pointed to by indirect block as well. Thus, when block 
1818 is modified and stored in a new disk location as 
block 1 824, the corresponding direct and indirect blocks 
are also copied and assigned to the active file system 
1830. 

[0098] Figure 19 is a diagram illustrating the 
changes occurring in block 1824 of Figure 18C. Block 
1824 of Figure 18C is represented within dotted line 
1824 in Figure 19. Figure 19 illustrates several levels of 
indirection for block 1824 of Figure 18C. The new block 
1910 that is written to disk in Figure 18C is labeled 1910 
in Figure 19. Because block 1824 comprises a data 
block 1910 containing modified data that is referenced 
by double indirection, two other blocks 1918 and 1926 
are also modified. The pointer 1924 of single-indirect 
block 1918 references new block 1910, therefore block 
1918 must also be written to disk in a new location. Sim- 
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ilarly, pointer 1928 of indirect biock 1926 is modified 
because it points to block 1 91 8. Therefore, as shown in 
Figure 19, modifying a data block 1910 can cause sev- 
eral indirect blocks 1918 and 1926 to be modified as 
well. This requires blocks 1918 and 1926 to be written to 
disk in a new location as well. 

[0099] Because the direct and indirect blocks 1 91 0, 
1918 and 1926 of data block 1824 of Figure 18C have 
changed and been written to a new location, the inode 
in the inode file is written to a new biock. The modified 
block of the inode file is allocated a new block on disk 
since data cannot be overwritten. 

[0100] As shown in Figure 1 9, block 1 91 0 is pointed 
to by indirect blocks 1 926 and 1 91 8, respectively. Thus 
when block 1910 is modified and stored in a new disk 
location, the corresponding direct and indirect blocks 
are also copied and assigned to the active file system. 
Thus, a number of data structures must be updated. 
Ghanging direct block 1910 and indirection blocks 1918 
and 1926 causes the blkmapfile to be modified. 
[0101] The key data structures for snapshots are 
the blkmap entries where each entry has multiple bits 
for a snapshot. This enables a plurality of snapshots to 
be created. A snapshot is a picture of a tree of blocks 
that is the file system (1830 of Figure 18). As long as 
new data is not written onto blocks of the snapshot, the 
file system represented by the snapshot is not changed. 
A snapshot is similar to a consistency point. 
[0102] The file system of the present invention is 
completely consistent as of the last time the fsinfo 
blocks 1810 and 1870 were written. Therefore, if power 
is interrupted to the system, upon restart the file system 
1830 comes up in a consistent state. Because 8-32 MB 
of disk space are used in typical prior art "clone" of a 1 
GB file system, clones are not conductive to consist- 
ency points or snapshots as is the present invention. 
[0103] Referring to Figure 22, two previous snap- 
shots 2110A and 2110B exist on disk. At the instant 
when a third snapshot is created, the root inode pointing 
to the active fiie system is copied into the inode entry 
21 10C for the third snapshot in the inode file 2110. At 
the same time in the consistency point that goes 
through, a flag indicates that snapshot 3 has been cre- 
ated. The entire file system is processed by checking if 
BITO for each entry in the blkmap file is set (1) or 
cleared (0). All the BITO values for each blkmap entry 
are copied into the plane for snapshot three. When 
completed, every active block 2110-2116 and 1207 in 
the file system is in the snapshot at the instant it is 
taken. 

[0104] Blocks that have existed on disk continu- 
ously for a given length ol time are also present in cor- 
responding snapshots 2110A-2110B preceding the 
third snapshot 21 1 0C. If a block has been in the file sys- 
tem for a long enough period of time, it is present in all 
the snapshots. Block 1207 is such a block. As shown in 
Figure 22, block 1207 is referenced by inode 221 OG of 
the active inode file, and indirectly by snapshots 1 , 2 



and 3. 

[0105] The sequential order of snapshots does not 
necessarily represent a chronological sequence Df fiie 
system copies. Each individual snapshot in a file system 

5 can be deleted at any given time, thereby making an 
entry available for subsequent use. When BITO of a blk- 
map entry that references the active file system is 
cleared (indicating the block has been deleted from the 
active file system), the block cannot be reused if any of 

w the snapshot reference bits are set. This is because the 
block is part of a snapshot that is still in use. A biock can 
only be reused when all the bits in the blkmap entry are 
set to zero. 

is Al gorithm for Generating a Snapshot 

[0106] Creating a snapshot is almost exactly like 
creating a regular consistency point as shown in Figure 
5. In step 510, all dirty inodes are marked as being in 

20 the consistency point. In step 520, all regular flies are 
flushed to disk. In step 530, special files (i.e., the inode 
file and the blkmap fiie) are flushed to disk. In step 540, 
the fsinfo blocks are flushed to disk. In step 550, all 
inodes that were not in the consistency point are proc- 

25 essed. Figure 5 is described above in detail. In fact, cre- 
ating a snapshot is done as part of creating a 
consistency point. The primary difference between cre- 
ating a snapshot and a consistency point is that all 
entries of the blkmap file have the active FS-bit copied 

30 into the snapshot bit The snapshot bit represents the 
corresponding snapshot in order to protect the blocks in 
the snapshot from being overwritten. The creation and 
deletion of snapshot is performed in step 530 because 
that is the only point where the file system is completely 

3s self-consistent and about to go to disk. 

[0107] Different steps are performed in step 530 
then illustrated in Figure 6 for a consistency point when 
a new snapshot is created. The steps are very similar to 
those for a regular consistency point. Figure 7 is a flow 

40 diagram illustrating the steps that step 530 comprises 
for creating a snapshot. As described above, step 530 
allocates disk space for the blkmap file and the inode file 
and copies the active FS-bit into the snapshot bit that 
represents the corresponding snapshot in order to pro- 

45 tect the blocks in the snapshot from being overwritten. 
[01 08] in step 71 0, the inodes of the blkmap file and 
the snapshot being created are pre-flushed to disk. In 
addition to flushing the inode of the blkmap file to a 
block of the inode file (as in step 610 of Figure 6 for a 

so consistency point), the inode of the snapshot being cre- 
ated is also flushed to a biock of the inode file. This 
ensures that the block of the inode file containing the 
inode of the snapshot is dirty. 

[01 09] In step 720, every block in the blkmap file is 
55 dirtied. In step 760 (described below), all entries in the 
blkmap file are updated instead of just the entries in 
dirty blacks. Thus, all blocks of the blkmap file must be 
marked dirty here to ensure that step 730 write-allo- 
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cates disk space for them. 

[0110] in step 730, disk space is allocated for all 
dirty blocks in the inode and blkmap files. The dirty 
blocks include the block in the inode file containing the 
inode of the blkmap file, which is dirty, and the block s 
containing the inode for the new snapshot. 
[011 1 ] In step 740, the contents of the root inode for 
the file system are copied into the inode of the snapshot 
in the inode file. At this time, every block that is part of 
the new consistency point and that will be written to disk 10 
has disk space allocated for it. Thus, duplicating the root 
inode in the snapshot inode effectively copies the entire 
active file system. The actual blocks that will be in the 
snapshot are the same blocks of the active file system. 
[0112] In step 750, the inodes of the blkmap file and is 
the snapshot are copied to into the inode file. 
[0113] In step 760, entries in the blkmap file are 
updated. In addition to copying the active FS-bit to the 
CP-bit for the entries, the active FS-bit is also copied to 
the snapshot bit corresponding to the new snapshot. so 
[01 14] In step 770, all dirty blocks in the blkmap and 
inode files are written to disk. 

[01 1 5] Finally, at some time, snapshots themselves 
are removed from the file system in step 760. A snap- 
shot is removed from the file system by clearing its 25 
snapshot inode entry in the inode file of the active file 
system and clearing each bit corresponding to the 
snapshot number in every entry in the blkmap file. A 
count is performed also of each bit for the snapshot in 
all the blkmap entries that are cleared from a set value, so 
thereby providing a count of the blocks that are freed 
(corresponding amount of disk space that is freed) by 
deleting the snapshot. The system decides which snap- 
shot to delete on the basis of the oldest snapshots. 
Users can also choose to delete specified snapshots 3s 
manually. 

[0116] The present invention limits the total number 
of snapshots and keeps a blkmap file that has entries 
with multiple bits for tracking the snapshots instead of 
using pointers having a COW bit as in Episode. An 40 
unused block has all zeroes for the bits in its blkmap file 
entry. Over time, the BIT0 for the active file system is 
usually turned on at some instant Setting BIT0 identifies 
the corresponding block as allocated in the active file 
system. As indicated above, all snapshot bits are initially 45 
set to zero. If the active file bit is cleared before any 
snapshot bits are set, the block is not present in any 
snapshot stored on disk. Therefore, the block is immedi- 
ately available for reallocation and cannot be recovered 
subsequently from a snapshot. so 

Generation of a Snapshot 

[0117] As described previously, a snapshot is very 
similar to a consistency point. Therefore, generation of a 55 
snapshot is described wilh reference to the differences 
between it and the generation of a consistency point 
shown in Figures 17A-17L. Figures 21A-21F illustrates 
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the differences for generating a snapshot. 
[0118] Figures 17A-17D illustrate the state of the 
WAFL file system when a snapshot is begun. All dirty 
inodes are marked as being in the consistency point in 
step 51 0 and regular files are flushed to disk in step 
520. Thus, initial processing of a snapshot is identical to 
that for a consistency point. Processing for a snapshot 
differs in step 530 from that for a consistency point. The 
following describes processing of a snapshot according 
to Figure 7. 

[0119] The following description is for a second 
snapshot of the WAFL file system. A first snapshot is 
recorded in the blkmap entries of Figure 17C. As indi- 
cated in entries 2324A-2324M, blocks 2304-2306, 
2310-2320, and 2324 are contained in the first snap- 
shot. All other snapshot bits (BIT1-B1T20) are assumed 
to have values of 0 indicating that a corresponding 
snapshot does not exist on disk. Figure 21 A illustrates 
the file system after steps 510 and 520 are completed. 
[0120] In step 710, inodes 2308C and 2308 D of 
snapshot 2 and blkmap file 2344 are pre-f lushed to disk. 
This ensures that the block of the inode file that is going 
to contain the snapshot 2 inode is dirty. In Figure 21 B, 
inodes 2308C and 2308D are pre-fiushed for snapshot 
2 and for blkmap file 2344. 

[0121] In step 720, the entire blkmap file 2344 is 
dirtied. This will cause the entire blkmap file 2344 to be 
allocated disk space in step 730. In step 730, disk space 
is allocated for dirty blocks 2308 and 2326 for inode file 
2346 and blkmap file 2344 as shown in Figure 21 C. This 
is indicated by a triple asterisk (***) beside blocks 2308 
and 2326. This is different from generating a consist- 
ency point where disk space is allocated only tor blocks 
having entries that have changed in the blkmap file 
2344 in step 620 of Figure 6. Blkmap file 2344 of Figure 
21 C comprises a single block 2324. However, when blk- 
map file 2344 comprises more than one block, disk 
space is allocated for all the blocks in step 730. 
[0122] In step 740, the root inode for the new file 
system is copied into inode 2308D for snapshots. In 
step 750, the inodes 2308C and 2308D of blkmap file 
2344 and snapshot 2 are flushed to disk as illustrated in 
Figure 21 D. The diagram illustrates that snapshot 2 
inode 2308D references blocks 2304 and 2308 but not 
block 2306. 

[0123] In step 760, entries 2326A-2326L in block 
2326 of the blkmap file 2344 are updated as illustrated 
in Figure 21 E. The diagram illustrates that the snapshot 
2 bit (BIT2) is updated as well as the FS-BIT and CP- 
BIT for each entry 2326A-2326L. Thus, blocks 2304, 
2308-2312, 2316-2318, 2322, and 2326 are contained 
in snapshot 2 whereas blocks 2306, 2314, 2320, and 
2324 are not. In step 770, the dirty blocks 2308 and 
2326 are written to disk. 

[0124] Further processing of snapshot 2 is identical 
to that for generation of a consistency point illustrated in 
Figure 5. In step 540, the two fsinfo blocks are flushed 
to disk. Thus, Figure 21 F represents the WAFL file sys- 
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tern in a consistent state after this step. Files 2340, 
2342, 2344, and 2346 of the consistent file system, after 
step 540 is completed, are indicated within dotted lines 
in Figure 21 F. In step 550, the consistency point is com- 
pleted by processing inodes that were not in the consist- 
ency point. 

Access Time Overwrites 

[01251 Unix file systems must maintain an "access 
time" {atime) in each mode. Atime indicates the last time 
that the file was read. It is updated every time the file is 
accessed. Consequently, when a file is read the block 
that contains the inode in the inode file is rewritten to 
update the mode. This could be disadvantageous for 
creating snapshots because, as a consequence, read- 
ing a file could potentially use up disk space. Further, 
reading all the files in the file system could cause the 
entire inode file to be duplicated. The present invention 
solves this problem. 

[0126] Because of atime, a read could potentially 
consume disk space since modifying an inode causes a 
new block for the inode file to written on disk. Further, a 
read operation could potentially fail if a file system is full 
which is an abnormal condition for a file system to have 
occur. 

[0127] In general, data on disk is not overwritten in 
the WAFL file system so as to protect data stored on 
disk. The only exception to this rule is atime overwrites 
for an inode as illustrated in Figures 23A-23B. When an 
"atime overwrites" occurs, the only data that is modified 
in a block of the inode file is the atime of one or more of 
the inodes it contains and the block is rewritten in the 
same location. This is the only exception in the WAFL 
system, otherwise new data is always written to new 
disk locations. 

[0128] In Figure 23A, the atimes 2423 and 2433 of 
an inode 2422 in an old WAFL inode file block 2420 and 
the snapshot inode 2432 that references block 2420 are 
illustrated. Inode 2422 of block 2420 references direct 
block 2410. The atime 2423 of inode 2422 is "4/30 9:15 
PM" whereas the atime 2433 of snapshot inode 2432 is 
"5/1 10:00 AM". Figure 23A illustrates the file system 
before direct buffer 2410 is accessed. 
[0129] Figure 23B illustrates the inode 2422 of 
direct block 2410 after direct block 2410 has been 
accessed. As shown in the diagram, the access time 
2423 of inode 2422 is overwritten with the access time 
2433 of snapshot 2432 that references it. Thus, the 
access time 2423 of inode 2422 for direct block 2410 is 
"5/1 1 1 :23 AM". 

[0130] Allowing inode file blocks to be overwritten 
with new atimes produces a slight inconsistency in the 
snapshot The atime of a file in a snapshot can actually 
be later than the time that the snapshot was created. In 
order to prevent users from detecting this inconsistency, 
WAFL adjusts the atime of all files in a snapshot to the 
time when the snapshot was actually created instead of 



Ihe time a file was last accessed. This snapshot time is 
stored in the inode that describes the snapshot as a 
whole. Thus, when accessed via the snapshot, the 
access time 2423 for inode 2422 is always reported as 

5 "5/1 10:00AM". This occurs both before the update 
when it may be expected to be "4/30 9: 15PM", and after 
the update when it may be expected to be "5/1 
1 1 :23AM". When accessed through the active file sys- 
tem, the times are reported as "4/30 9:15PM" and "5/1 

10 1 1 :23AM" before and after the update, respectively. 
[0131] In this manner, a method is disclosed for 
maintaining a file system in a consistent state and for 
creating read-only copies of the f ile system. 

15 Claims 

1 . A method for recording a plurality of data about a 
plurality of blocks of data stored in storage means, 
the method comprising the steps of: 

20 

maintaining a means for recording multiple 
usage bits per block of said storage means; 
storing, in said means for recording multiple 
usage bits per block, multiple bits for each of 
25 said plurality of said blocks of said storage 

means; and 

reusing at least one of said plurality of blocks of 
data in response to at least one of said multiple 
usage bits. 

30 

2. A method for maintaining a file system comprising 
blocks of data stored in blocks of a non-volatile stor- 
age means at successive consistency points, the 
method comprising the steps of: 

35 

storing a first file system information structure 
for a first consistency point in said non-volatile 
storage means, said first file system informa- 
tion structure comprising data describing a tay- 

40 out of said file system at said first consistency 

point of said file system- 
writing blocks of data of said file system that 
have been modified from said first consistency 
point as of the commencement of a second 

45 consistency point to free blocks of said non-vol- 

atile storage means; 

storing in said non-volatile storage means a 
second file system information structure for 
second consistency point, said second file sys- 
so tern information . structure comprising data 

describing a layout said file system at said sec- 
ond consistency point of said file system. 

3. A method according to claim 2, wherein said step of 
55 storing said first file system information structure in 

said non-volatile storage means comprises the step 
of: 
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storing first and second copies of said first file 
system information structure at first and sec- 
ond locations respectively of said non-volatile 
storage means; 

and wherein said step of storing said second s 
file system information structure in said non- 
volatile storage means comprises the steps of: 
overwriting said first copy of said first file sys- 
tem information structure with a first copy of 
said second file system information structure; to 
and 

overwriting said second copy of said first file 
system information structure with a second 
copy of said second file system information 
structure. w 

A method according to claim 3, wherein said first 
and second locations of said non-volatile storage 
means comprise iixed pre-determined locations of 
said non-volatiie storage means. 20 

A method according to claim 3 or 4, wherein each 
copy of said file system information structure com- 
prises means for determining a most recent version 
of said file system information structure and means 25 
for determining validity of said file system informa- 
tion structure, the method further comprising the 
steps of: 

after a system failure, reading said first and 30 
second copies of said file system information 
structure from said first and second locations of 
said non-volatiie storage means; 
determining a most recent valid file system 
information structure from said first and second 35 
copies of said file system information structure. 

A method for creating a plurality of read-only copies 
of a file system stored in blocks of a non-volatile 
storage means, said file system comprising meta- 40 
data identifying blocks of said non-volatile storage 
means used by said file system, the method com- 
prising the steps of: 

storing meia-data for successive states of said 45 
file system in said non-volatile storage means; 
making a copy of said meta-data at each of a 
plurality of said states of said file system; 
for each of said copies of said meta-data at a 
respective state of said file system, marking so 
said blocks of said non -volatile storage means 
identified in said meta-data as comprising a 
respective read-only copy of said file system. 

A method according to claim 6, wherein said step of 55 
marking said blocks comprising a respective read- 
only copy of said file system comprises placing an 
appropriate entry in a means for recording multiple 
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usage bits per block of said non-volatile storage 
means. 

8. A method according to claim 7 wherein said means 
for recording multiple usage bits per block of said 
non-volatile storage means comprises a block map 
comprising multiple bit entries for each block. 

9. A method according to claim 6, 7 or 8, wherein said 
meta-data comprises pointers to a hierarchical tree 
of blocks comprising said file system. 

10. A method according to claim 6, 7, 8 or 9, wherein 
said meta-data comprises structures representing 
files of said file system. 

11. A method according to claim 10, wherein said 
structures representing files of said file system 
comprise modes. 

12. A method according to any one of claims 6 to 11, 
further comprising the step of: 

preventing overwriting of said blocks marked as 
belonging to a read-only copy of said file sys- 
tem. 

13. A method according to any one of claims 6 to 12, 
comprising the step of unmarking said blocks 
marked as belonging to a read-only copy of said file 
system when said read-only copy of said file sys- 
tem is no longer needed. 

14. A method according to any one of claims 6 to 13, 
wherein a plurality of said blocks marked as belong- 
ing to a read-only copy of said file system comprise 
data ancillary to said file system, said method fur- 
ther including the steps of: 

allowing said ancillary data to be overwritten; 
and 

otherwise preventing overwriting of said blocks 
marked as comprising a read-only copy of said 
file system. 

1 5. A method according to claim 1 4 wherein said ancil- 
lary data comprises access time data. 

16. A method according to any one of claims 6 to 15, 
wherein said meta-data comprises a root structure 
referencing structures representing files of said file 
system, and wherein said copies of said meta-data 
comprise copies of said root structure. 

17. A method according to claim 16, wherein said root 
structure comprises a root inode. 

18. A method according to any one of claims 6 to 17, 
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further comprising the step of using one or more of 
said read-only copies of said fiie system to back-up 
said blocks comprising one or more consistency 
points of said file system. 

5 

19. Apparatus far reading a plurality of blocks of data 
stored in storage means; the apparatus comprising: 

usage bit recording means for recording multi- 
ple usage bits for each block of said storage 10 

storing means for writing multiple bits per block 
of said storage means to said usage bit record- 
ing means; 

recording means for recording data to said is 
storage means to reuse at least one of said plu- 
rality of blocks in response to at least one of 
said multiple usage bits. 

20. Apparatus for maintaining a file system comprising zo 
blocks of data stored in blocks of non-volatile stor- 
age means at successive first and second consist- 
ency points, the apparatus comprising: 

first storing means for storing in said non-vola- 25 
tile storage means a first file system informa- 
tion structure for a first consistency point, said 
first file system information structure compris- 
ing data describing a layout of said file system 
at said first consistency point thereof; so 
writing means for writing blocks of data of said 
file system that have been modified from said 
first consistency point to free blocks of said file 
system; 

second storage means for storing in said non- 35 
volatile storage means a second file system 
information structure for said second consist- 
ency point, said second file system information 
structure comprising data describing a layout of 
said file system at said second consistency 40 
point of said fiie system, 

21. Apparatus according to claim 20, wherein said first 
storing means is adapted to store first and second 
copies of said first file system information structure 45 
at first and second locations respectively; and said 
second storing means is adapted to overwrite said 
first and second copies of said first file system infor- 
mation structure with first and second copies of 
said second file system information structure. so 

22. Apparatus for creating a plurality of read-only cop- 
ies of a file system stored in blocks of a non-volatile 
storage means, said file system comprising meta- 
data identifying blocks of said non-volatile storage ss 
means used by said file system, the apparatus 
comprising: 



storing means for storing meta-data for succes- 
sive states of said file system in said non-vola- 
tile storage means; 

copying means for making a copy of said meta- 
data at each of a plurality of said states of said 
file system; and 

marking means, operative for each of said cop- 
ies of said meta-data, for marking said blocks 
identified in said meta-data as comprising a 
respective read-only copy of said file system. 
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(57) The present invention provides a method for 
keeping afile system in a consistent state andforcreating 
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is not updated, the state of the file system represented 
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is initially created. It is designed so that many different 
snap shots can be created for the same file system. Un- 
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present invention duplicates only the inodethat describes 
the inode file. A multi-bit free-block map file (1630) is 
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